home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / accs / n_mouse / n_mouse.txt < prev   
Encoding:
Text File  |  1991-05-11  |  8.9 KB  |  191 lines
  1. *****************************************************************
  2. *                                                               *
  3. *                  Manual N_MOUSE 1.2 08/04/91                  *
  4. *                                                               *
  5. *                   (C) Noud van Kruysbergen                    *
  6. *                                                               *
  7. *****************************************************************
  8.  
  9. N_MOUSE.LZH contains:
  10.  
  11. - N_MOUSE.ACC, the accessory program
  12. - N_MOUSE.RSC, the resource belonging to it
  13. - N_MOUSE.INF, a info file that contains the default settings
  14. - N_MOUSE.TXT, this manual
  15.  
  16. This program is a accessory, so copy them all (except 
  17. N_MOUSE.TXT) to your boot disk (usually drive A or C). Reboot and 
  18. N_MOUSE is activated. The menu entry 'Mouse Control' in the 
  19. leftmost (accessory) menu is added.
  20.  
  21. N_MOUSE is a accessory that takes control of the mouse. You can 
  22. speed the mouse, invert it, show the mouse coordinates, change 
  23. buttons etc.
  24.  
  25. Options:
  26.  
  27. - Double Click: this sets the double click speed of the mouse 
  28. buttons. 0 is slow, 4 is (very) fast.
  29.  
  30. - Mouse Buttons: you can change the functions of the mouse 
  31. buttons. Noramlly the left mouse button is the most important 
  32. one, and the right button is rarely used. If you want to change 
  33. these two than select the 'RL' option, meaning that the right (R) 
  34. and left (L) mouse button functions are changed. Selecting 'LL' 
  35. makes both mouse buttons behave like the left button, and 'RR' 
  36. makes them both behave like a right button. This 'RR' option is a 
  37. dangerous one, because you cannot activate programs or select 
  38. menu's: there is no left button any more! That is why a alertbox 
  39. appears when you select 'RR' whether you really want this option 
  40. to be selected. There is a way to escape if you selected 'RR' or 
  41. any other option and want to switch back to 'LR' again: press one 
  42. of the Shift keys and select 'OK' , the default button. Things 
  43. will be like normal again.
  44.  
  45. - Mouse Speed: the speed of the mouse can be changed. The 'V/2' 
  46. option slows the mouse down to half its speed. The 'V*#' options 
  47. speeds the mouse with factor #. This factor is editable (0-9). 
  48. V*2 means that hte mouse speed is doubled. V*0 would mean the 
  49. mouse is dead, so a alertbox appears telling you that this would 
  50. disable the mouse and restoring the value to the normal V*1. 
  51. 'V*V' make the mouse behalve in a quadratic way: moving the mouse 
  52. 1 pixel remains 1 pixel, moving it 2 pixels becomes 4, moving it 
  53. 3 becomes 9 etc. This options is especially usable with big 
  54. screen monitors.
  55.  
  56. - Show Coordinates: this options shows the coordinates on screen 
  57. all the time. This is done by writing to the screen directly. The 
  58. coordinates are shown like +0000:+0000, which is mouse x position 
  59. : mouse y position. The '+' is added because the position can be 
  60. negative (see 'Show Zero'). When the left button is pressed a 'L' 
  61. appears on the ':' spot. 'R' or 'B' (both) appear when the right 
  62. button or both buttons are pressed.
  63.  
  64. - Mouse Scroll. This is a nice feature that enables auto-
  65. scrolling. When you're editing a textfile in Wordplus or any 
  66. other GEM editor, you have to select a tiny button to scroll the 
  67. file with the mouse. When 'Mouse Scroll' is activated you can 
  68. scroll down by moving the mouse to the bottom of the screen, and 
  69. up by scrolling it to the top. You can also move the cursor to 
  70. the left by moving the mouse to the left side of the screen and 
  71. to the right by moving it to the right side. The text will be 
  72. scrolled as long as you keep the mouse on the edge of the screen.
  73.  
  74. - X continuous: don't stop at the horizontal edge of the screen, 
  75. but move to the other side. If you select this option the mouse 
  76. does not stop at the left edge of the screen, but 'rotates' to 
  77. the right side of the screen and vice versa.
  78.  
  79. - Y continuous: the same function for the vertical axe. When you 
  80. move the mouse to the top of the screen it will appear at the 
  81. bottom and the other way around.
  82.  
  83. - Disable menu. When I am editing a file it happens every now and 
  84. then that I am moving the mouse by accident. If it enters the 
  85. menu zone, then a menu flips down and I have to move out of the 
  86. menu and click at the left button. In order to avoid this you can 
  87. select the 'Disable Menu' option. The mouse will not enter the 
  88. menu zone unless you press the right mouse button at the same 
  89. time you're entering.
  90.  
  91. - Options. Some of the above functions need some extra informa-
  92. tion. This 'Options' options shows a new resource, and the next 
  93. options:
  94.      - Show Zero X and Y. Normally the mouse zero point is at the 
  95.      left top of the screen. Editing the Zero X and Y values sets 
  96.      a new zero point. Entering '320' and '200' set the zero 
  97.      point at the middle of the standard 640*400 monochrome 
  98.      resolution. Moving the mouse to the left top of the screen 
  99.      now shows the coordinates -0320:-0200. This option is usable 
  100.      when drawing graphs: you can set the mouse zero point to the 
  101.      (0,0) point in the graph.
  102.      - Don't Scroll. When 'Mouse Scroll' is selected the auto-
  103.      scrolling mode is enabled. If you want to scroll up however 
  104.      you'll probably enter a menu when you're moving the mouse 
  105.      up. This is very annoying. So I added the 'Don't Scroll' 
  106.      positions: between these two positions there is no auto-
  107.      scrolling. So when you enter 0020 to 0300 there is no auto-
  108.      scrolling when the mouse is moved to the top of the screen 
  109.      between these two positions. Set these values in such a way 
  110.      that there is no overlap between the scrolling-positions and 
  111.      the menu, or just don't enter a menu!
  112.      - Show in Font. The information written to the screen when 
  113.      'Show Coordinates' is selected can be done in one of the 
  114.      three fonts shown. Simply select the one you prefer.
  115.      - Show Y Up. Normally the Y axe from 0 to 400 is from the 
  116.      top to the bottom of the screen. With this option the 
  117.      coordinates shown are from the bottom to the top, so the 
  118.      normal way for humans.
  119.      - Scroll X. When 'Mouse Scroll' is selected, you can select 
  120.      whether you what scrolling in the hirozontal direction by 
  121.      selecting this option or not. The same is true for
  122.      - Scroll Y in the vertical direction.
  123.      - Invert X. This option inverts the mouse direction in the 
  124.      horizontal way. Moving the mouse to the right makes the 
  125.      mouse on the screen move to the left and vice versa.
  126.      - Invert Y does the same for the Y direction.
  127.      - Show Location. There are 9 screen positions selectable 
  128.      where the mouse coordinates can be shown when the 'Show 
  129.      Coordiantes' option is selected.
  130.      - Main. Return to the main resource.
  131.  
  132. - Save. The options selected at this moment can be saved. The 
  133. file N_MOUSE.INF is opened when it exists or created when it does 
  134. not exist. The current settings are saved to this file and the 
  135. next time you boot up these will be the default setttings. Only 
  136. the first 32 bytes of N_MOUSE.INF are of importance: the rest is 
  137. merely to explain what means what in this file, but can be 
  138. deleted.
  139.  
  140. - Info. A resource showing my name and things like that.
  141.  
  142. - OK. Activate the options selected and return to the desktop.
  143.  
  144. There are a few things that need some further explaining, because 
  145. there are possible interactions. Activating 'Mouse Scroll' auto-
  146. matically disables the 'X Continuous' and 'Y Continuous' options. 
  147. A continuous mouse does not allow scrolling in horizontal way! 
  148. When 'Scroll X' is selected 'X Continuous' is deselected when 
  149. 'Mouse Scroll' is selected. When 'Mouse Scroll' is deselected the 
  150. old 'X Continuous' state is set again.
  151.  
  152. Error messages appear when you do not have a monochrome monitor 
  153. or the resource N_MOUSE.RSC is missing. N_MOUSE is not installed 
  154. in those cases.
  155.  
  156. When N_MOUSE.INF does not exist at booting time the accessory 
  157. default settings will be used.
  158.  
  159. N_MOUSE is supposed to work on all ST's that allow line A 
  160. opcodes. If this sounds too technical for you then just try and 
  161. see if it works.
  162.  
  163. N_MOUSE only works in monochrome mode. The (pixel) size of the 
  164. screen should not matter.
  165.  
  166. N_MOUSE installs two new mouse vectors and a VBL routine. This is 
  167. done using the XBRA method with ID 'NMC2'.
  168.  
  169. N_MOUSE is strictly PD: feel free use it and copy it.
  170.  
  171. This program is tested within selected circumstances, and did a 
  172. fine job. I can not be held responsible for the (mis)use of 
  173. N_MOUSE however. If there are any problems, ideas, comments or 
  174. suggestions, please let me know. Updates will only be available 
  175. when there are good ideas from the people that actually use the 
  176. program!
  177.  
  178. Noud van Kruysbergen
  179. NICI
  180. PO Box 9104
  181. 6500 Nijmegen
  182. the Netherlands
  183. email:kruysbergen@nici.kun.nl
  184.  
  185. *   * *  ***  *     * *   *     *   *
  186. **  * * *   * *    *  *   *     **  *
  187. * * * * *     *   *   *   *  *  * * *
  188. *  ** * *   * *  *    *   * * * *  **
  189. *   * *  ***  * *      ****  *  *   *
  190.  
  191.